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Foreword 



rd , 



This Technical Specification (TS) has been produced by the 3 Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 



rd , 



The present document is part of a TS-family covering the 3 Generation Partnership Project: Technical Specification 
Group Services and System Aspects; Telecommunication management, as identified below: 

TS 32.411: "Performance Management (PM) Integration Reference Point (IRP): Requirements"; 

TS 32.412: "Performance Management (PM) Integration Reference Point (IRP): Information Service 

(IS)"; 

TS 32.413: "Performance Management (PM) Integration Reference Point (IRP): Common Object Request 

Broker Architecture (CORBA) Solution Set (SS)"; 

TS 32.414: "Performance Management (PM) Integration Reference Point (IRP): Common Management 

Information Protocol (CMIP) Solution Set (SS)". 

The present document is part of a set of TSs which describe the requirements and information model necessary for the 
Telecommunication Management (TM) of 3G systems. The TM principles and TM architecture are specified in 
3GPPTS 32.101 [1] and3GPPTS 32.102 [2]. 

A 3G system is composed of a multitude of Network Elements (NE) of various types and, typically, different vendors, 
which inter-operate in a co-ordinated manner in order to satisfy the network users' communication requirements. 
Any evaluation of PLMN-system behaviour will require performance data collected and recorded by its NEs according 
to a schedule established by the EM. 

This aspect of the management environment is termed Performance Management. The purpose of any Performance 
Management activity is to collect performance related data, which can be used to locate potential problems in the 
network. 
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Scope 



The present document specifies the Information Service for the Performance Management Integration Reference Point 
(PM IRP) as it applies to the Itf-N. 

This IRP IS defines the semantics of operations (and their parameters) visible across the Itf-N in a protocol and 
technology neutral way. It does not define the syntax or encoding of the operations and their parameters. 
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Definitions and abbreviations 



3.1 



Definitions 



For the purposes of the present document, the terms and definitions defined in 3GPP TS 32.41 1 [8] and 
3GPP TS 32.401 [7] apply. 



3.2 



Abbreviations 



For the purposes of the present document, the following abbreviations apply: 

CM Configuration Management 

CMIP Common Management Information Protocol 

CMIS Common Management Information Service 

CORBA Common Object Request Broker Architecture 

EM Element Manager 

IOC Information Object Class 

IRP Integration Reference Point 

NE Network Element 

NM Network Manager 

NRM Network Resource Model 

PM Performance Management 

PMIRP Performance Management Integration Reference Point 

UML Unified Modelling Language 



4 System overview 

4.1 System context 

Figures 4. 1 and 4.2 identify system contexts of the IRP defined by the present specification in terms of its 
implementation called IRP Agent and the user of the IRP Agent, called IRPManager. For a definition of IRPManager and 
IRP Agent, see 3GPP TS 32.102 [2]. 

The IRP Agent implements and supports this IRP. The IRP Agent can reside in an Element Manager (EM) (see 

figure 4.1) or a Network Element (NE) (see figure 4.2). In the former case, the interfaces (represented by a thick dotted 

line) between the EM and the NEs are not the subject of this IRP. 

An IRP Agent supports one of the two System Contexts defined here. By observing the interaction across this Itf-N, an 
IRPManager cannot deduce if EM and NE are integrated in a single system or if they run in separate systems. 
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Figure 4.1 : System Context A 
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Figure 4.2: System Context B 



4.2 Compliance rules 



For general definitions of compliance rules related to qualifiers (Mandatory/Optional/Conditional) for operations, 
notifications and parameters (of operations and notifications) please refer to 3GPP TS 32.102 [2]. 



Void 



6 Information Object Classes (lOCs) 

6.1 Information entities imported and local labels 



Label reference 


Local label 


3GPP TS 32.622 [6], information object class, Top 


Top 


3GPP TS 32.622 [6], information object class, IRPAgent 


IRPAgent 


3GPP TS 32.312 [5], information object class, ManagedGenerlcIRP 


ManagedGenerlcIRP 


3GPP TS 32.602 [9], information object class, Managed Entity 


Managed Entity 


3GPP TS 32.302 [12], information object class, NotificationIRP 


NotificationIRP 


3GPP TS 32.662 [13], information object class, KernelGMIRP 


KernelGMIRP 


3GPP TS 32.1 11 -2 [4], information object class, AlarmlRP 


AlarmlRP 


3GPP TS 32.342 [10], information object class, FileTransferlRP 


FileTransferlRP 
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6.2 Class diagram 

6.2.1 Attributes and relationships 

This clause introduces the set of Information Object Classes (lOCs) that encapsulate information within the 
IRP Agent. The intent is to identify the information required for the PMIRP Agent implementation of its operations 
and notification emission. This clause provides the overview of all support object classes in UML. Subsequent clauses 
provide more detailed specification of various aspects of these support object classes. 



<lnformationObjectClass» 
PMIRP 



«lnformationObjectClass» 
JobMeasurementSchedule 
+ job Schedule 
+ job Start Time 
+ jobStopTime 



+thePMIRP 



relation -pmRF\-rwasureme ntJobLlst 



+theJobSchedule ^ 

relatlon-measurementJob JobMeasurementSchedule 

+theMeasurementJob 



«lnformationObjectClass» 
MeasurementJobList 



+theMeasurementJobList 

relation-measurementJobList-measurementJob 



■jobListId 



+theMeasurementJobList 



0..n 

+theMeasuiementJob 



c<lnformationObjectClass» 
MeasurementJob 

- jobid 

- jobGranularityPeriod 

- jobReportingPeriod 

- jobStatus 



1 

+theMeasurementJob 

relation-rreasurerrentJpb-rreasurennent 

+theMeasurernent 

1..n 

<lnformationObjectClass» 
MeasurementReader 



■ measurementResultValue 



«lnformationObjectClas^> 
MeasuredAttribute 


1 




relation-measuredAttflbute-managedEntity 


«ProxyClasB» 
ManagedEntity 


+ measurementTypeName 


1..n 1 













Figure 6.1(a): Information Object Class UML Diagram - lUleasurement 
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«lnformationObjectClass» 

ThresholdLevel 
+ threshold Value 
+ thresholdSeverity 
+ hyderesis 



1..4 



«lnformationObjectClass» 
PMIRP 



J +thePMIRP 
relation-pmlRP-thrssholdMonitorList 



\/ +theThresholdMonitorList 



«lnformationObjectClass» 
ThresholdMonitorList 



• monitorListId 



+theThresholdMonitorList 



relation-thresholdMonitorList-thresholdMonitor 



0..n 



+theThresholdMonitor 



«lnformationObjectClass» 
ThresholdMonitor 



+ thresholdMonitorStatus 



1 \ 



+theThresholdMonitor 



rel atioiUhresholdMonitor-measurement 



+theThresholdLevel 



1..n 



4-theMeasurement 



relation-measuredAttribute-thresholdLevels 



+theMeasuredAttribute 

A 

«lnformationObjectClass» 
MeasuredAttribute 



«lnformationObjectClass» 
MeasurementReader 

+ measurementResultValue 



relation-measuredAttribute-managedEntity 



+ measurementTypeName 



1..n 



«ProxyClass» 
ManagedEntity 



Figure 6.1(b): Information Object Class UML Diagram - Thresholding 
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+thePMIRP 



relation-pniFP-threshotdMonitorList 



+theThresholdMonitorList 



«lnformationObjectClass» 

ThresholdMonitorList 
+ monitorListld 



0..n 



+theThresholdMonitorList 
relation-thresholdMonltqrLlst-thresholdMonltor 



«lnformationObjectClass» 
ThresholdMonitor 



- threshold Moni to rStatus 



«lnformationObjectClass» 
PMIRP 



«lnformationObjectClass» 
JobMeasurementSchedule 
+ job Schedule 
+ job Start Time 
+ jobStopTime 



▼ +thePMIRP 
relation-pmlRP-measuremsntJobList 



+theJobSchedule 



1 



«lnforTnationObjectClass» 

MeasurementJobList 
+ jobListld 



relation-measurerwntJob-jobMe^surementSchedule 
+theMeasurementJob 
+theMeasurementJobList 

relation-msasurementJobList-measurerwntJob 



«lnformationObjectClass» 
Measurement Job 



+theMeasurementJobLia 



■ jobid 

^^ + jobGranularityPeriod 

0..n + jobReportingPeriod 
+theMeasurementJob +jobStatus 



1 \/ +theMeasurementJob 
relation-measuremdntJob-measuremsnt 



+theThreshold Monitor 

+theThresholdMonitQr 



1..n 



+theMeasurement 



«lnformationObjectClass» 
+theMeasurement MeasurementReader 



1 



relatlon-thresholdMonitor-weasufement 



1..n 



■ measurementResultValue 



«lnformationObjectClass» 

ThresholdLevel 
+ thresholdValue 
+ thresholdSeverity 
+ hysteresis 



relation-rneasuiBdAttribute-thresholdLevels 



<<lnformationObjectClass» 
MeasuredAttribute 



+theThresholdLevel 



+theMeasuredAttribute + measurementTypeName 



rel ation -rw asuredAtttibute -ma nage dEntity 



1..n 



«ProxyClass» 
ManagedEntity 



Figure 6.1(c): Information Object Class UML Diagram - Combined 
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«lnformation Object Class» 

ManagedGenericIRP 

(from TS 32.312) 



«lnformationObjectClass» 
PMIRP 



«lnformation Object Class» 
Monitor 



«lnformation Object Class» 

Top 

(fromTS 32.622) 



+ monitorld 

+ monitorGranularityPeriod 

+ eventType 

+ probableCause 

+ specificProblem 

+ direction 




«lnformation Object Class» 
TInresholdLevel 

+ threstioldValue 
+ threstioldSeverity 
+ hysteresis 



«lnformation Object Class» 
MeasurementJobList 



■ jobListId 



«lnfoimation Object Clas» 

TfirestioldMonitorList 
+ monitorListId 



«lnformation Object Class» 
ThrestioldMonitor 



- tfireslioldMonitorStatus 



«lnformation Object Class» 
MeasurementJob 



- jobid 

- jobGranularityPeriod 

- jobReportingPeriod 

- jobStatus 



«lnformation Object Class» 
JobMeasurementScfiedule 

+ jobSchedule 
+ jobStartTime 
+ jobStopTime 



«lnformation Object Class» 
MeasuredAttribute 



■ measurementTypeName 



«lnformation Object Class» 
MeasurementReader 



■ measurementResultValue 



Figure 6.2: Information Object Class Inheritance UML Diagram 
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6.3 Information Object Class (lOCs) definitions 



6.3.1 MeasurementJob 



6.3.1.1 



Definition 



It represents a task that monitors and collects the performance measurement data, i.e. values of multiple 
measurementTypes of multiple ManagedEnt ity instances, at regular time intervals defined in 

JobMe a surement Schedule. 

The target measurementTypes are those measurementTypes, whose names are in the related MeasuredAttribute . 

measurementTypeName, of the related ManagedEntity instances. The attributes of Measurement Job, 
JobMeasurementSchedule and MeasuredAttribute can not be modified (except jobStatus) once a 
measurement job is created. 

The MeasurementJob shall use its information and the information of the related JobMeasurementSchedule 
and the information of MeasuredAttribute(s) to perform measurement data collection during the 
MeasurementJob life-time. At the time of data collection, if Measurement Job suspects the validity of the 
collected monitored values, the MeasurementJob should convey the fact to the IRPManager using the suspectFlag 
(3GPP TS 32.401 [7]) of the Report. The MeasurementJob will not emit any notification about this fact. 
Furthermore, the MeasurementJob shall continue to monitor the same target measurementTypes. Even in the worst 
possible case when the MeasurementJob cannot collect a single value from the target measurementTypes, the 
MeasurementJob must continue its activities according to the schedule created at MeasurementJob creation 
time. 

The PMIRP Agent may decide to stop a MeasurementJob because of a PMIRP Agent internal problem or other 
problems such as in the case when the related managed resource is not accessible (e.g. uninstalled) or there exist a 
prolonged communication link problem between the PMIRP Agent and the related managed resource. In such case, the 
PMIRP Agent can stop the MeasurementJob resulting in the MeasurementJob . jobStatus == "Stopped". 
Additionally, " notifyMeasurementJobStatusChanged" notification shall be emitted to notify all subscribed 
IRPManagers about the stopping of a MeasurementJob. 

The PMIRP Agent may also selectively suspend one or more MeasurementJobs without any operator"s action in case of 
overload. In such case, the PMIRP Agent suspends all the chosen MeasurementJob(s) resulting in the 
MeasurementJob.jobStatus == 'Suspended' and emit 'notifyMeasurementFobStatusChanged' notification for each 
MeasurementJob to notify all subscribed IRPManager(s) about the suspension. The behaviour on threshold monitors of 
PMIRP Agent after suspending is the same as the one after calling suspendMeasurementJob. 

Then it should be possible, at any time, for the operator to resume a MeasurementJob suspended by the system. PMIRP 
agent may also resume the measurementJob by itself after detecting the end of the overload. When PMIRP Agent does 
not support the resumeMeasurementJob operation, PMIRP Agent shall resume the measurementJob automatically after 
detecting the end of overload. The behaviour of PMIRP Agent after resuming the measurementJob is the same as the 
one after calling resumeMeasurementJob. PMIRP Agent may suspend the corresponding measurementJob(s) when it can 
decide which one/ones cause(s) the overload; otherwise, PMIRP Agent can take jobPriority as a reference. The criterion 
for suspending one or another measurementJob of equal job priority is vendor specific. 

The way to detect the beginning and the end of overload is out of the scope of the present document. 



6.3.1.2 



Attributes 



Attribute name 


Visibility 


Support Qualifier 


Read Qualifier 


Write Qualifier 


jobid 


+ 


M 


M 


- 


jobGranularityPeriod 


+ 


M 


M 


- 


jobReportingPeriod 


+ 


M 


M 


- 


jobStatus 


+ 


M 


M 


- 


jobPriority 


+ 





M 


- 
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6.3.1.3 



State diagram 



The measurement t^ 
job is visible via Itf-N 



create 



stoplVleasurementJob 
or stopped by system 




The measurement job is 
visible via Itf-N and not 
removed in IRPAgent 



Stopped 



stopTime reached or 
, , , stopMeasuj^entJob or 

suspendMeasur^mer\tJob \ stopped by system 



TfT 



stopTinie reached or 

StoplVleasurementJob or 

'^ ,, »,">\ stopped by system 

resumeMeasurementJob\ , 1 

and startTimereached 



The measurement L 
job is removed in 
IRPAgent 



suspendMeasurementJob 
or suspended by system 



Active 



Figure 6.3: State Diagram for IVIeasurementJob 



Active 



Busy 




schedule^ reached 
schedule ended 



Idle 




Figure 6.4: SubState Diagram of Active 

The detailed description and state transition scenarios for Measurement Job are in annex A. 

6.3.2 JobMeasurementSchedule 



6.3.2.1 



Definition 



JobMeasurementSchedule is the representation of the time intervals when the measurement job monitors and 
collects the performance measurement data. The attributes of JobMeasurementSchedule can not be modified 
once a measurement job is created. 
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6.3.2.2 



Attributes 



Attribute name 


Visibility 


Support Qualifier 


Read Qualifier 


Write Qualifier 


jobStartTime 


+ 


M 


M 


- 


jobStopTime 


+ 


M 


M 


- 


jobSchedule 


+ 


M 


M 


- 



6.3.3 PMIRP 



6.3.3.1 



Definition 



PMIRP is the representation of the performance management capabiHties specified by the present document. This IOC 
inherits fromManagedGenericIRP IOC specified in 3GPP TS 32.312 [5]. 

6.3.4 MeasurementJobList 

6.3.4.1 Definition 

MeasurementJobList is the representation of the list of Measurement Jobs. 

6.3.4.2 Attributes 



Attribute name 


Visibility 


Support Qualifier 


Read Qualifier 


Write Qualifier 


jobUstId 


+ 


M 


M 


- 



6.3.5 MeasuredAttribute 



6.3.5.1 



Definition 



It represents the name of the measurementType of the related ManagedEntity instance whose value is to be 
monitored and collected. The name of the monitored and collected measurementType is captured by 
measurementTypeName. 



6.3.5.2 



Attributes 



Attribute name 


Visibility 


Support Qualifier 


Read Qualifier 


Write Qualifier 


measurementTypeName 


+ 


M 


M 


- 



6.3.6 MeasurementReader 



6.3.6.1 



Definition 



It represents the capability to read the value of the measurementType of the related ManagedEntity instance. The 
value of the monitored and collected measurementType is captured by measurementResultValue. 



6.3.6.2 



Attributes 



Attribute name 


Visibility 


Support Qualifier 


Read Qualifier 


Write Qualifier 


measurementResultValue 


+ 


M 


M 


- 
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6.3.7 ManagedEntity 



6.3.7.1 



Definition 



The IOC ManagedEntity represents the role that can be played by an instance of an IOC defined in Network 
Resources Models, e.g. Generic Network Resource Model, Core Network Resource Model, UTRAN Network Resource 
Model or GERAN Network Resource Model. It also represents the role that can be played by an instance of VSE 
subclass of 3GPP defined NRM lOCs or VSE defined NRM lOCs. ManagedEntity is used in the specification of 
PMIRP operations to represent an instance of an IOC defined in these Network Resource Models. 

6.3.8 Monitor 



6.3.8.1 



Definition 



It represents a capability to determine the (a) threshold-crossing or (b) threshold-reaching and the threshold-clearing. 
This class is abstract in that it cannot be instantiated. The ThresholdMonitor inherits this class. 

It is the IRPAgent"s choice to support (a) or (b) (but not both). The support is on an IRP Agent system wide basis and is 
not on a per threshold basis. The IRPAgent"s behaviour regarding which approach (i.e., (a) or (b) above) to use, shall be 
the same for emitting alarms and for clearing alarms. 

The instances of a class derived from this abstract class shall emit notifyObjectCreation when they are first created; and 
shall emit a notifyObjectDeletion when deleted. 

The instances of a class derived from this abstract class shall also emit notifyNewAlarm, notifyChangedAlarm and 
notifyClearedAlarm according to the rules specified in Annex B: Threshold Alarm Triggering Events. 
The ob jectClass and ob jectlnstance parameter of these notifications carry the class and DN of the 
ManagedEntity whose measurementType is being monitored and whose threshold condition has been triggered. 



6.3.8.2 



Attribute 



Attribute name 


Visibility 


Support Qualifier 


Read Qualifier 


Write Qualifier 


monitorld 


+ 


M 


M 


- 


monitorGranularityPeriod 


+ 


M 


M 


- 


eventJype 


+ 


M 


M 


- 


probableCause 


+ 


M 


M 


- 


specificProblem 


+ 


M 


M 


- 


direction 


+ 


M 


M 


- 



6.3.8.3 



Notification 



Notification name 


Note 


notifyObjectCreation 


See clause 7.1 (class diagram). 


notifyObjectDeletion 


See clause 7.1 (class diagram). 



6.3.9 ThresholdMonitorLlst 



6.3.9.1 



Definition 



ThresholdMonitorList is the representation of the list of ThresholdMonitors. 



6.3.9.2 Attributes 



Attribute name 


Visibility 


Support Qualifier 


Read Qualifier 


Write Qualifier 


monitorUstld 


+ 


M 


M 


- 
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6.3.10 ThresholdMonitor 



6.3.10.1 



Definition 



In order to monitor the overall health of the network, the thresholds are set by the authorized users to generate network 
performance related alarms. The ThresholdMonitor contains the values of the threshold settings for the PM 
parameters. If the threshold is (a) crossed or (b) reached (see 6.3.8.1 for clarification of the alternatives (a) and (b)), a 
performance alarm will be emitted (see 3GPP TS 32.401 [7]). The name of the monitored measurementType is captured 

by MeasuredAt tribute .measurementTypeName and the value of it is captured by 

Measurement Reader .measurement Re sultValue. 



6.3.10.2 



Attribute 



Attribute name 


Visibility 


Support Qualifier 


Read Qualifier 


Write Qualifier 


thresholdMonitorStatus 


+ 


M 


M 


- 



6.3.11 ThresholdLevel 



6.3.11.1 



Definition 



It defines the thresholding criteria (via ThresholdLevel . thresholdValue and 

ThresholdLevel . hysteresis) for a measurementType. It also specifies the thresholdSeverity level (via 
ThresholdLevel . thresholdSeverity) carried in the alarm triggered by the (a) threshold crossing or (b) 
threshold reaching event. (See 6.3.8.1 for clarification of the alternatives (a) and (b)). 



6.3.11.2 



Attribute 



Attribute name 


Visibility 


Support Qualifier 


Read Qualifier 


Write Qualifier 


thresholdValue 


+ 


M 


M 


- 


thresholdSeverity 


+ 


M 


M 


- 


hysteresis 


+ 


M 


M 


- 



6.4 Information relationship definitions 

6.4.1 relation-pmlRP-measurementJobLlst (M) 
6.4.1.1 Definition 

This represents the relationship between PMIRP and Measurement JobList. 



6.4.1.2 



Role 



Name 


Definition 


theMeasurementJobList 


It represents the Measurement JobLlst. 


thePMIRP 


It represents the pmirp. 



6.4.1.3 



Constraint 



Name 



Definition 



uniqueJobListId 



The jobListlds playing the role of thelVleasurementJobList, are unique within a particular pmirp. 



£75/ 



3GPP TS 32.412 version 6.3.0 Release 6 



20 



ETSI TS 132 412 V6.3.0 (2004-12) 



6.4.2 relation-measurementJobList-measurementJob (M) 
6.4.2.1 Definition 

This represents the relationship between Measurement JobList and Measurement Job. 



6.4.2.2 



Role 



Name 


Definition 


theMeasurementJob 


It represents the Measurement Job. 


theMeasurementJobList 


It represents the Measurement JobList. 



6.4.2.3 Constraint 



Name 



Definition 



uniqueJobId 



The joblds of all Measurement Jobs, playing the role of theMeasurementJob, are 
unique within a particular PMIRP and Measurement JobList. 



6.4.3 relation-measurementJob-jobMeasurementSchedule (M) 
6.4.3.1 Definition 

This represents the relationship between Measurement Job and JobMeasurementSchedule. 



6.4.3.2 



Role 



Name 


Definition 


theJobSchedule 


It represents the JobMeasurementSchedule. 


theMeasurementJob 


It represents the Measurement Job. 



6.4.4 relation-measurementJob-measurement (M) 
6.4.4.1 Definition 

This represents the relationship between Measurement Job and MeasurementReader. 



6.4.4.2 



Role 



Name 


Definition 


theMeasurement 


It represents the MeasurementReader. 


theMeasurementJob 


It represents the Measurement Job. 



6.4.5 relation-measuredAttribute-managedEntity (M) 
6.4.5.1 Definition 

This represents the relationship between MeasuredAttribute and ManagedEntity. 
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6.4.5.2 



Role 



Name 


Definition 


theMeasuredAttribute 


The MeasuredAttribute, when playing this role, reads the monitored measurement types 
of the related ManagedEntity instances. The names of measurement types are captured by 
the MeasuredAttribute. MeasurementTypeName . When playing this role, the 
MeasuredAttribute is aware of the class name and DN of the ManagedEntity. 


theME 


The ManagedEntity, when playing this role, represents the actual network resource 
instance under measurement or whose measurementTypes are being monitored for (a) 
threshold-crossing or (b) threshold-reaching and threshold-clearing. (See 6.3.8.1 for 
clarification of the alternatives (a) and (b)) 



6.4.5.3 



Constraint 



Name 


Definition 


applyToSameObjectClass 


The MeasuredAttribute, which playing the role of "theMeasuredAttribute", can monitor 
the thresholds of the measurementTypes of one or multiple managed object instances of the 
same managed object class, which playing the role of "thelVIE". 



6.4.6 relation-pmlRP-thresholdMonitorList (M) 

6.4.6.1 Definition 

This represents the relationship between PMIRP and ThresholdMonitorList. 

6.4.6.2 Role 



Name 


Definition 


theThresholdMonitorList 


It represents the ThresholdMonitorList. 


thePMIRP 


It represents the pmirp. 



6.4.6.3 Constraint 



Name 



Definition 



uniquelVlonitorLlstid 



The monitorListlds playing the role of theThresholdMonitorList, are unique within a particular 

PMIRP. 



6.4.7 relatlon-thresholdMonitorLlst-thresholdMonltor (M) 
6.4.7.1 Definition 

This represents the relationship between ThresholdMonitorList and ThresholdMonitor. 



6.4.7.2 



Role 



Name 


Definition 


theThresholdMonitor 


It represents the ThresholdMonitor. 


theThresholdMonitorList 


It represents the ThresholdMonitorList. 
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6.4.7.3 



Constraint 



Name 



Definition 



uniqueMonitorld 



The monitorlds of all ThresholdMonitors, playing the role of theThresholdMonitor, are unique 
within a particular ThresholdMonitorList. 



6.4.8 relation-thresholdMonitor-measurement (M) 
6.4.8.1 Definition 

This represents the relationship between ThresholdMonitor and MeasurementReader. 



6.4.8.2 



Role 



Name 


Definition 


theMeasurement 


It represents the MeasurementReader. 


theThresholdMonitor 


It represents the ThresholdMonitor. 



6.4.9 relation-measuredAttribute-thresholdLevels (M) 
6.4.9.1 Definition 

This represents the relationship between MeasuredAttribute and ThresholdLevel. 



6.4.9.2 



Role 



Name 


Definition 


thel\/leasuredAttribute 


The MeasuredAttribute, when playing this role, can have 1 ..4 ThresholdLevel associates 
with it to set the (a) threshold-crossing or (b) threshold reaching and the clearing criteria 
(i.e. ThresholdLevel . thresholdValue, ThresholdLevel . hysteresis) and associated 
thresholdSeverity (i.e. ThresholdLevel . thresholdSeverity) of the monitored 
measurementType. (see 6.3.8.1 for clarification of the alternatives (a) and (b)) 


theThresholdLevel 


When playing this role, the ThresholdLevel captures the (a) threshold-crossing or (b) 
threshold-reaching and the threshold-clearing criteria and its associated thresholdSeverity level, 
(see 6.3.8.1 for clarification of the alternatives (a) and (b)) 



6.4.9.3 



Constraint 



Name 


Definition 


nolVloreThanFourLevels 


A MeasuredAttribute may have no more than four ThreshoidLeveis associated 
with it. 



6.5 



Information attribute definition 



6.5.1 Definition and legal values 



Attribute Name 


Definition 


Legal Values 


direction 


For some measurementType, the higher its 
thresholdValue, the higher is the thresholdSeverity. 
For others, the lower its thresholdValue, the higher 
is its thresholdSeverity. This attribute identifies if 
the measurementType is of the former 
(i.e. "Increasing") or latter type (i.e. "Decreasing"). 
If it is "Increasing", the threshold event is triggered 


Possible values are: "Increasing", 
"Decreasing" 



£75/ 



3GPP TS 32.412 version 6.3.0 Release 6 



23 



ETSI TS 132 412 V6.3.0 (2004-12) 



Attribute Name 


Definition 


Legal Values 




when the value first equals or exceeds (when 
compared against the last read value) a threshold 
value. The threshold is said to be cleared when the 
measurementType value falls below (when 
compared against the last read value) one or more 
threshold values. 

If it is "Decreasing", the threshold event is 
triggered when the measurementType value first 
equals or falls below one or more threshold values. 
The threshold is said to be cleared when the 
measurementType value rises above the threshold 
value. 

See annex B (Threshold Related Performance 
Alarm Triggering Events) for details of the 
behaviour of multiple thresholds. 




eventType 


It identifies the event type carried by the 
performance alarm. 


The value is "Quality of Service Alarm". 
See3GPPTS32.111-2[4]. 


hysteresis 


A threshold has a value. It can have a hysteresis. 
A threshold with a hysteresis has a threshold-high 
and a threshold-low value that are different from 
the threshold value. 

A hysteresis, therefore, defines the threshold-high 
and threshold-low levels within which the 
measurementType value is allowed to oscillate 
without triggering a (a) threshold-crossing or (b) 
threshold-reaching or a threshold-clearing 
condition. (See 6.3.8.1 for clarification of the 
alternatives (a) and (b)) 
threshold-high = threshold + hysteresis 
threshold-low = threshold - hysteresis 
See annex B (Threshold Related Performance 
Alarm Triggering Events). 


Any positive value 


jobGranularityPeriod 


It specifies the period between two successive 
measurements. 


The value can be 5 minutes, 15 
minutes, 30 minutes, 1 hours, 12 hours 
and 24 hours. 

The minimum granularity period is 5 
minutes in most cases, but for some 
measurements it may only make sense 
to collect data in a larger granularity 
period. 


jobid 


It identifies the Measurement Job instance (and 
distinguishes it from all other existing and stopped 
Measurement Job instances of the PMiRP Agent). 


Any identifier except: 

1 . Those that identify 
Measurement Job instances 
whose 

Measurement Job . jobStatus 
( s ) are Scheduled, Active, 
Suspended or Stopped; and 

2. Those that appear in filenames of 
files ready for IRPIVIanager 
retrieval. 


jobListId 


It identifies the singleton Measurement JobList 
of the PMIRP Agent. 


Any identifier. 


jobReportingPeriod 


It specifies the period between two successive 
emissions of notifyFileReady or 
notifyFilePreparationError [10]. The two 
notifications are related to the same Job. See 
constraints reportTime in clause 6.5.2. 


Its value should be one or multiple of 
jobGranularityPeriod. 


jobSchedule 


It specifies the detailed time frames during which 

the Measurement Job . jobStatus = Active and 
its substate = Busy. 


Its value is only one of the following, 
dailyScheduling or weeklyScheduling. 
The legal values for them refer to ITU-T 
Recommendation X.721 [3]. 
The legal values for them are as follows. 
dailyScheduling: 

{{ intervalStart {hour 0, minute 0}, 
intervalEnd {hour 23, minute 59}}} 
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Attribute Name 


Definition 


Legal Values 






weeklyScheduling: 
{{daysOfWeek '1111111'B, 
IntervalsOfDay dailyScheduling}} 


jobStartTlme 


It specifies tlie begin time from which the 
Measurement Job will be active. 


All values that indicate valid timestamp. 


jobStatus 


It specifies the status of Measurement Job. 


Its value should be one of the following: 

Scheduled, 

Active, 

Suspended 

Stopped 


jobPriority 


It specifies the priority of IVIeasurementJob 


Its value should be one of the following: 

Low, 

Medium, 

High 


jobStopTime 


It specifies the end time after which the 
Measurement Job will be Stopped. 


All values that indicate valid timestamp 

and it should be later than 

jobStartTime.lt's not necessary that 

jobStartTime and jobStopTime specifies 

time within the same day. 

This attribute may carry the value 

"indefinitely". 


measurementResultValue 


It identifies the value of a measurement type. 


Any valid measurement result value. 


measurementTypeName 


It identifies a name of one measurement type 
whose value is being collected and monitored. 


Any valid measurement type name as 
defined by the measurement definition 
template in 3GPP TS 32.403 [14]. 


monitorGranularityPeriod 


It specifies the period between two successive 
reading of the thresholdValue to determine (a) 
threshold-crossing or (b) threshold-reaching and 
threshold-clearing. (See 6.3.8.1 for clarification of 
the alternatives (a) and (b)) 


It can be 5 minutes, 15 minutes, 

30 minutes, 1 hour, 12 hours or 

24 hours. 

It has to be a multiple of the 

jobGranularityPeriod if the 

Measurement Job monitoring the same 

measurementType exists. 


monitorld 


It identifies the ThreshoidMonitor instance (and 
distinguishes it from all other existing 
ThreshoidMonitor instances Of the PMIRP 
Agent). 


Any identifier except those that are 
currently used. 


monitorListId 


It identifies the singleton 

ThresholdMonitorList in the PMIRP Agent. 


Any identifier. 


probableCause 


It identifies the probable cause (of the (a) threshold 
crossing or (b) threshold reaching) carried by the 
threshold crossing or reaching alarm. (See 6.3.8.1 
for clarification of the alternatives (a) and (b)) 


"Threshold Grossed" 


thresholdSeverity 


It identifies the thresholdSeverity of the (a) 
threshold crossing or (b) threshold reaching event. 
(See 6.3.8.1 for clarification of the alternatives (a) 
and (b)) 


Warning, Minor, Major, Critical 


specificProblem 


It identifies the specific problem (causing the (a) 
threshold crossing or (b) threshold reaching) 
carried by the threshold crossing or reaching 
alarm. (See 6.3.8.1 for clarification of the 
alternatives (a) and (b)) 


Any valid specificProblem as defined by 
3GPPTS32.111-2[4]. 


thresholdMonitorStatus 


It specifies the current status of the 
ThreshoidMonitor. 


Active - ThreshoidMonitor is 

working; 

Suspended - ThreshoidMonitor is 

suspended. 


thresholdValue 


It defines the threshold value of the monitored 
measurementTypes. If the value is (a) crossed or 
(b) reached, the performance alarm shall be 
emitted depending on the value of the 
thresholdMonitorStatus. (See 6.3.8.1 for 
clarification of the alternatives (a) and (b)) 


If the monitored measurementType is of 
Gauge type, this thresholdValue shall be 
of the same type. 

If the monitored measurementType is of 
counter type, then this value should be 
expressed as a rate, i.e., the number of 
units of type of the monitored 
measurementType over unit of time. 
Note this rate is independent from the 
monitorGranularityPeriod. This means 
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Attribute Name 


Definition 


Legal Values 






that changes in the 
monitorGranularityPeriod should not 
impact the rate used for threshold 
monitoring. 



6.5.2 Constraints 



Name 


Definition 


firstReportTime 


If the jobReportingPeriod is n times the jobGranularityPeriod, then the first report time shall 
be immediately after the completion of the n-th successful measurementType reading. 


measurementTypeReadTi 
mes 


The measurementType reading times are determined by the following rules. 

- If JobGranularityPeriod is 5 minutes, then read on every 5* minute of the hour. 

- If JobGranularityPeriod is 1 5 minutes, then read on every 1 5* minute of the hour. 

- If JobGranularityPeriod is 30 minutes, then read on every 30* minute of the hour 

- If JobGranularityPeriod is 1 hour, then read on every hour of the day 

- If JobGranularityPeriod is 12 hours, then the first read shall be as soon as possible on 
the hour and subsequent reads shall be at 12 hours interval. 

- If JobGranularityPeriod is 24 hours, then the first read shall be as soon as possible on 
the hour and subsequent reads shall be at 24 hours interval. 


multiLevelSeverity 
HysteresisOverlap 


For each ThresholdLevel . thresholdSeverity, there may be a 
ThreshoidLevei. hysteresis value corresponding to it. These multi-level values of 
ThresholdLevel . hysteresis, relating to one ThresholdMonitor, shall not overlap. 


multiLevelSeverityOrder 


The multiple ThresholdLevel (s) , related to one ThresholdMonitor, shall be of the 
following order. If ThresholdLevel . thresholdSeverity of one instance is higher 
than that of the other instance and the direction is 'Increasing', then the 
ThresholdLevel . thresholdvalue is higher than that of the Other. If 
ThresholdLevel . thresholdSeverity of one instance is higher than that of the other 
instance and the direction is 'Decreasing', then the ThresholdLevel . thresholdvalue 
is lower than that of the other. 


numberOfThresholdLevel 
PerThresholdMonitor 


In relation-tlVlonitor-tLevel, the multiplicity of thoThresholdLevel is "1 ..4". 

If PMiRP supports multi-level thresholdSeverity, then there are at most 4 

ThresholdLevels relating to one ThresholdMonitor. All 

ThresholdLevel . thresholdSeverity instances shall hold a different value that is 

chosen from the following: 'Critical', 'IVIajor', "Warning' and 'IVIinor'. 

If PMIRP does not support multi-level thresholdSeverity, then there is only one 

ThresholdLevel relating to one ThresholdMonitor. The sole 

ThresholdLevel . thresholdSeverity shall hold one of the following: 'Critical', 

'Major', "Warning' or 'Minor'. 
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Interface definition 



7.1 Class diagram 
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«may use» 

«Notification» 

AlarmlRPNotifications_2 

(from TS 32.111) 



«Notification» 

AlarmlRPNotifications_1 

(from TS 32.111) 



«use» 

«Notificafon» 

FilelransferlRPNotifocationsI 

(from TS 32.342) 



- suspendThresfioldMonitorO 

- resumelhresholdMonitorO 



« Interface » 

FilelransferlRPOperationsI 

(from TS 32.342) 



NOTE 1 : The notifyThresholdMonitorStatusChanged notification is mandatory if PI\/IIRPOperations_2 is supported 
NOTE 2: The suspendlVleasurementJob and resumeMeasurementJob operations are optional. 

Figure 7.1 : Class Diagram 



7.2 



Generic rules 



Rule 1: each operation with at least one input parameter supports a pre-condition vahd_input_parameter which 
indicates that all input parameters shall be valid with regards to their information type. Additionally, each such 
operation supports an exception operation_failed_invalid_input_parameter which is raised when pre-condition 
valid_input_parameter is false. The exception has the same entry and exit state. 

Rule 2: each operation with at least one optional input parameter supports a set of pre-conditions 
supported_optional_input_parameter_xxx where "xxx" is the name of the optional input parameter and the pre- 
condition indicates that the operation supports the named optional input parameter. Additionally, each such 
operation supports an exception operation_failed_unsupported_optional_input_parameter_xxx which is raised 
when (a) the pre-condition supported_optional_input_parameter_xxx is false and (b) the named optional input 
parameter is carrying information. The exception has the same entry and exit state. 
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Rule 3: each operation shall support a generic exception operation_failed_internal_problem which is raised 
when an internal problem occurs and that the operation cannot be completed. The exception has the same entry 
and exit state. 

NOTE: These rules are mapped at the solution set level. Pre-conditions and exceptions, generated by these rules, 
need not appear explicitly in the present document. 

7.3 PMIRPOperations_1 Interface (M) 
7.3.1 Operation createMeasurementJob (M) 
7.3.1.1 Definition 

This operation supports IRPManager's request to create a Measurement Job through Itf-N. 

Once created, the attributes of Measurement Job (except Measurement Job . jobStatus) and the related 
JobMeasurementSchedule and MeasuredAttribute will not be modified during the life-time of the 

Measurement Job. 

One Measurement Job can collect the value of one or multiple measurementTypes. 

When a measurementType is collected by one Measurement Job for a given instance, another Measurement Job 
which wants to collect the same measurementType for the same instance with different or the same 
jobGranularityPeriod may be rejected. This behaviour shall be consistent for a given implementation by a specific 
vendor. 
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7.3.1.2 



Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


iOCName 


IVI 


ManagedEntity . ob jectClass 


It specifies one IVIanaged Entity class 
name. iRPManager requests that one 
or more measurementType{s) of the 
instances of this class to be monitored. 


iOCInstanceList 


M 


List of <ManagedEntitY . objectInstance> 


It specifies the list of DNs of 

IVIanagedEntity instances whose 

measurementType(s) are to be 

collected. 

At least, one instance shall be 

specified. 


measurementCategoryList 


M 


List of < 

MeasuredAttribute . 
measurement TYpeName> 


MeasuredAttribute . 
MeasurementTypeName specifies the 
corresponding name of 
measurementType to be measured. 

The element of 

measurementCategoryList could be 
one of the following: 

- The form 

"family. measurementName.subcounter" 
can be used in order to retrieve a 
specified subcounter of a 
IVIeasurementType. 

- The form 

"family.measurementName" can be 
used in order to retrieve a specific 
IVIeasurementType. In case the 
MeasurementType includes 
subcounters, all subcounters will be 
retrieved. 

- The form "family" can be used in 
order to retrieve all MeasurementTypes 
in this family. 

At least, one element of 
measurementCategoryList shall be 
specified. 


granularityPeriod 


M 


Measurement Job . jobGranularityPeriod 


See clause 6.5.1 (definition and legal 
values). 


reporting Period 


M 


Measurement Job . jobReportingPeriod 


See clause 6.5.1 (definition and legal 
values). 

PMiRP will periodically monitor the 
performance data according to the 
"reportingPeriod" parameter and 
produces an aggregated report in one 
or more files. These files shall be 
transferred through file transfer 
mechanism covered by the File 
Transfer IRP IS (see 3GPP TS 32.342 
[101). 


startTime 





JobMeasurementSchedule . jobStartTime 


See clause 6.5.1 (definition and legal 

values). 

Default value is "start now". If startTime 

is in the past, the current time will be 

used and the job will start immediately. 


stopTime 





JobMeasurementSchedule . jobStopTime 


See clause 6.5.1 (definition and legal 

values). 

Default value for jobStopTime is to run 

indefinitely. StopTime shall be later 

than StartTime and current time. 


schedule 





JobMeasurementSchedule . jobSchedule 


See clause 6.5.1 (definition and legal 

values). 

Default value is "daily". 


priority 





JobMeasurement Job . jobPriority 


See clause 6.5.1 (definition and legal 
values). 
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Parameter Name 


Qualifier 


Information type 


Comment 








Default value is 'Medium' 



7.3.1.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


jobid 


M 


Measurement Job . jobId 


Unique identifier of the Measurement Job 
from all the existing and stopped 

Measurement Jobs in a PMIRP Agent. 


unsupported List 


M 


List of < 

ManagedEntity . ob jectlnstance, 

MeasuredAttribute . 
measurementTypeName, 

reason 
> 


To create a Measurement Job, best-effort 
is required. The parameter of 
'unsupportedLlst' must be returned if status 
= PartialSuccess. 
The reason can be any of: 
measurementTypeName is unknown to the 

PMIRP. 

measurementTypeName is invalid. 
measurementTypeName is not supported 
in the specific implementation. 
The related IOC Instance is unknown 
(e.g. it does not exist at the time of this 
operation invocation) to the pmirp. 
Insufficient capacity to monitor the related 
IOC Instance(s). 

measurementTypeName is already 
monitored for the IOC instance with the 
same or another granularity period. 


status 


M 


ENUM (Success, Failure, PartialSuccess) 


An operation may fail because of a 
specified or unspecified reason. 



7.3.1.4 



Pre-condition 



atLeastOneValidMeasurementType AND validStartTime AND validStopTime AND 
validSchedule AND validGranularityPeriod AND validReportingPeriod AND 
suf f icientCapacity AND validPriority. 



Assertion Name 


Definition 


atLeastOneValidMeasurem 
entType 


At least one input measurementType is valid. The word valid means that the pmirp is 
aware of this measurementType name, is aware of the ManagedEntity holding such 
measurementType and that the Measurement Job created can monitor its value 
according to the monitoring criteria, e.g. granularity period, given in the input parameter. 


validStartTime 


The startTime is valid. 


validStopTime 


The stopTime is valid. 


validSchedule 


The schedule is valid. 


validGranularityPeriod 


The granularityPeriod is valid. 


validReportingPeriod 


The reportingPeriod is valid. 


sufficentCapacity 


The resource of EM and NE can support the requested measurement. 


validPriority 


The priority is valid. 



7.3.1.5 



Post-condition 



someMeasurementTypeNamesMonitored AND 

notif yMeasurement JobStatusChangedMayBeEmitted. 



Assertion Name 


Definition 


someMeasurementTypeNam 
esMonitored 


At least one input measurementTypeName is monitored by the newly created 

Measurement Job. 


notifyMeasurementJobStatu 
sChangedMayBeEmitted 


If Start time is "start now", the Measurement Job. jobstatus turns "Active" and a 
notifyMeasurementJobStatusChanged is emitted. 
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7.3.1.6 



Exceptions 



Exception Name 


Definition 


InvalidStartTime 


Condition: validStartTime is false. 

Returned Information: Name of the exception; status is set to 'Failure'. 

Exit state: Entry state. 


invalidStopTime 


Condition: validStopTime is false. 

Returned Information: Name of the exception; status is set to 'Failure'. 

Exit state: Entry state. 


invalidSchedule 


Condition: validSchedule is false. 

Returned Information: Name of the exception; status is set to 'Failure'. 

Exit state: Entry state. 


invalidGranularityPeriod 


Condition: validGranularityPeriod is false. 

Returned Information: Name of the exception; status is set to 'Failure'. 

Exit state: Entry state. 


InvalidReportingPeriod 


Condition: validReportingPeriod is false. 

Returned Information: Name of the exception; status is set to 'Failure'. 

Exit state: Entry state. 


highWorkLoad 


Condition: sufficientCapacity is false. 

Returned Information: Name of the exception and the detailed reason which is one of: 

emCpuBusy; emHDShortage, emLowMemory, {neCpuBusy, neObjectlnstList}, 

{neHDShortage neObjectlnstList}, {neLowlVlemory, neObjectlnstList}, maxJobReached, 

otherReason; status is set to 'Failure'. 

Exit state: Entry state. 


invalidPriority 


Condition: validPriority is false. 

Returned Information: Name of the exception; status is set to "Failure". 

Exit state: Entry state. 



7.3.2 Operation stopMeasurementJob (M) 



7.3.2.1 



Definition 



This operation supports IRPManager's request to stop a Measurement Job through Itf-N, after which, the 
Measurement Job may still be visible via Itf-N. Whether the Measurement Job is removed from the managed 
system is vendor specific and out of scope of the present document. 

The behaviour of the IRP Agent when the job is stopped is vendor specific, which means the job could be stopped at the 
end of the GranularityPeriod or immediately. 

After the job has been stopped, the notifyFileReady or notifyFilePreparationError notification shall be emitted 
immediately or when the next reporting period is reached. 



7.3.2.2 



Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


Jobid 


M 


Measurement Job. jobId 


It specifies the Measurement Job to be Stopped. 



7.3.2.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


Status 


M 


ENUM (Success, Failure) 


An operation may fail because of a specified or 
unspecified reason. 



7.3.2.4 



Pre-condition 



measurement JobExists AND measurement JobCanBeStopped. 
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Assertion Name 


Definition 


measurementJobExists 


Measurement Job specified in tlie input parameter exists. 


measurementJobCanBeStopped 


Measurement Job specified in the input parameter can be stopped now. 



7.3.2.5 Post-condition 

measurement Job Is stopped AND notif yMeasurement JobStatusChangedEmitted. 



Assertion Name 


Definition 


measurementJoblsStopped. 


The Measurement Job identified by jobid is stopped but may still be 
visible via Itf-N. The Job state is "Stopped". 


notify IVIeasurementJobStatusChangedEmltted 


The notifyMeasurementJobStatusChanged is emitted. 



7.3.2.6 



Exceptions 



Exception Name 


Definition 


unknownJob 


Condition: (MeasurementJobExists) not verified. 

Returned information: output parameter status is set to 'Failure'. 

Exit state: Entry State. 


jobCannotBeStopped 


Condition: (measurementJobCanBeStopped) not verified. 
Returned information: output parameter status is set to 'Failure'. 
Exit state: Entry State. 



7.3.3 Operation suspendMeasurementJob (O) 



7.3.3.1 



Definition 



This operation supports IRPManager's request to suspend a Measurement Job through Itf-N. When the 
Measurement Job is suspended,the collection of measurement result data by the Measurement Job will stop, 
regardless of its schedule, but the Measurement Job still exists. The suspend operation is necessary in following 
situation: 

High work load experienced by managed system. 

The specified measurement data is not needed in a specific duration. 

Other specific requirement. 

After the job has been suspended, the notify FileReady or notify FilePreparationError notification shall be emitted 
immediately or when the next reporting period is reached. 



7.3.3.2 



Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


jobid 


M 


Measurement Job . jobid 


It specifies the Measurement Job to be suspended. 



7.3.3.3 



Output parameters 



Parameter 
Name 


Qualifier 


Matching Information 


Comment 


status 


M 


ENUM 
(Success, Failure) 


An operation may fail because of a specified or unspecified 
reason. 



7.3.3.4 



Pre-condition 



measurementJobExists AND measurement JoblsNotSuspended. 
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Assertion Name 


Definition 


measurementJobExists 


The Measurement Job specified in tlie input parameter exists. 


measurementJoblsNotSuspended 


The Measurement Job specified in the input parameter is not suspended. 



7.3.3.5 



Post-condition 



measurement JoblsSuspended AND notify ThresholdMonitorStatusChangedEmitted AND 

notif yMeasurement JobStatusChangedEmitted. 



Assertion Name 


Definition 


IVleasurementJoblsSuspe 
nded 


The Measurement Job identified by measurementJobId is suspended. It means the following. 

(a) All files open for capturing measurement results are closed. 

(b) If one of the files closed contain measurement data, a notifyFileReady is emitted 
indicating the availability of the file{s). 

(c) No more reading of measurementType values. 

(d) The Measurement Job . jobstatus is set to 'Suspended'. 

(e) For an IRPAgent using the measurement result data for threshold monitoring, the 
detection of the related performance alarm conditions is suspended. 


notify ThresholdlVlonitorSt 
atusChangedEmitted 


The notifyThresholdMonitorStatusChanged is emitted, if the ThresholdMonitor behaviour is 
dependent on the availability of the measurement result. 


notify IVIeasurementJobSta 
tusChangedEmitted 


The notifylVleasurementJobStatusChanged Is emitted. 



7.3.3.6 



Exceptions 



Exception Name 


Definition 


unknownJob 


Condition: (measurementJobExists) not verified. 

Returned information: output parameter status is set to 'Failure'. 

Exit state: Entry State. 


jobAlreadySuspended 


Condition: (measurementJoblsNotSuspended) not verified. 
Returned information: output parameter status is set to 'Failure'. 
Exit state: Entry State. 



7.3.4 Operation resumeMeasurementJob (O) 



7.3.4.1 



Definition 



This operation supports IRPManager's request to resume a suspended Measurement Job. When the 
Measurement Job is resumed, it will work according to criteria (e.g. granularity period, startTime, stopTime, 
schedule) set up by the corresponding createMeasurement Job operation. 



7.3.4.2 



Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


jobid 


M 


Measurement Job . jobId 


It specifies the Measurement Job to be resumed. 



7.3.4.3 



Output parameters 



Parameter 
Name 


Qualifier 


Matching Information 


Comment 


status 


M 


ENUM (Success, 
Failure) 


An operation may fall because of a specified or unspecified 
reason. 



7.3.4.4 Pre-condition 

measurementJobExists AND measurement JoblsSuspended AND suf f icientCapacity. 
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Assertion Name 


Definition 


measurementJobExists 


Measurement Job specified by the input parameter exists. 


measurementJoblsSuspended 


Measurement Job specified by the input parameter is suspended. 


sufficientCapacity 


The resource of EM and NE can support the 
requested measurement. 



7.3.4.5 



Post-condition 



measurement Job Is Resumed AND notif yMeasurement JobStatusChangedEmitted. 



Assertion Name 


Definition 


measurementJobIs 
Resumed 


The Measurement Job identified by MeasurementJobId is resumed., It means the 
following. This resumed Measurement Job shall behave as it did when it was first created 

by createMeasurement Job. 

Depending on the current time and the JobMeasurementSchedule . startTime, the 

Measurement Job . jobstatus will be set accordingly. 


notify IVIeasurement 
JobStatusChanged 
Emitted 


The notifylVleasurementJobStatusChanged is emitted. 



7.3.4.6 



Exceptions 



Exception Name 


Definition 


unknownJob 


Condition: (measurementJobExists) not verified. 

Returned information: output parameter status is set to 'Failure'. 

Exit state: Entry State. 


joblsNotSuspended 


Condition: (measurementJoblsSuspended) not verified. 
Returned information: output parameter status is set to 'Failure'. 
Exit state: Entry State. 


highWorkLoad 


Condition: sufficientCapacity is false. 

Returned Information: Name of the exception and the detailed reason which 
is one of: emCpuBusy; emHDShortage, emLowMemory, {neCpuBusy, 
neObjectlnstList}, {neHDShortage neObjectlnstList}, {neLowMemory, 
neObjectlnstList}, maxJobReached, otherReason; status is set to 'Failure'. 
Exit state: Entry state. 



7.3.5 Operation listMeasurementJobs (M) 



7.3.5.1 



Definition 



This operation supports IRPManager's request to list the information of all or a set of specified current 

Measurement Jobs. 



7.3.5.2 



Input parameters 



Parameter 
Name 


Qualifier 


Information type 


Comment 


jobldList 


M 


List of 

<Measurement Job. jobId> 


This parameter specifies the criteria to list the 

Measurement Jobs. 

If the parameter specifies the list of jobid to be retrieved, then 

the corresponding information of jobs will be returned. 

If the parameter contains no information, all the 

Measurement Jobs are retrieved. 



£75/ 



3GPP TS 32.412 version 6.3.0 Release 6 



34 



ETSI TS 132 412 V6.3.0 (2004-12) 



7.3.5.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


joblnfoList 


M 


List of< 


Returned information of corresponding 






attributes of Measurement Job, 


Measurement Jobs matching the input 






attributes of 


criteria. If no match, then the length of the 






JobMeasurement Schedule, 


joblnfolist will be (with status == 






(refer to definition and legal values in 


Success). 






clause 6.5.1) 








iOCName, 








lOCinstanceList, 








measurementCategoryList 








(refer to input parameter of 








createlVleasurementJob in clause 7.3.1 .2) 

> 




status 


M 


ENUM (Success, Failure) 


An operation may fail because of a 
specified or unspecified reason. 



7.3.5.4 Pre-condition 

jobldListlsValid. 



Assertion Name 


Definition 


jobldListlsValid 


jobidList specified in the input parameter is valid. 



7.3.5.5 



Post-condition 



measurement JobsAreReturned AND measurement JobNotAffected. 



Assertion Name 


Definition 


measurementJobsAreReturned 


The information of required Measurement Jobs are returned in the output parameters. 


measurementJobNotAffected 


The current Measurement Job ( s ) are not affected by the operation. 



7.3.5.6 



Exceptions 



Exception Name 


Definition 


InvalidJobldList 


Condition: (jobidListisVaiid) not verified. 

Returned information: output parameter status is set to 'Failure'. 

Exit state: Entry State. 



7.4 PMIRPOperations_2 Interface (O) 
7.4.1 Operation createThresholdMonitor (M) 



7.4.1.1 



Definition 



This operation supports IRPManager's request to create a ThresholdMonitor that defines the thresholds for some 
specific measure mentTypes. If the threshold defined is (a) crossed or (b) reached, the related performance alarms will 
be emitted to subscribed IRPManager ( s ) . 

Two cases are allowed: 

One case only accepts threshold monitoring of measurementType(s) that are already under monitoring by an 
existing Measurement Job. This kind of PMIRP will not monitor a measurementType for (a) threshold- 
crossing or (b) threshold reaching or for clearing if that measurementType is not already subject to a 
Measurement Job monitoring. This kind of PMIRP will only determine the (a) threshold crossing or (b) 
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threshold reaching and clearing events when the related Measurement Job ( s ) are in Active states. The 
IRPManager, when interacting with this kind of PMIRP, must first start a Measurement Job to monitor the 
measurementTypes and then invoke this operation for the same measurementXypes. 

The other case is that it can accept threshold monitoring of measurementType(s) regardless if they are already 
under monitoring by existing Measurement Job ( s ) . ThresholdMonitor is independent of any existing 
Measurement Job(s) and no new Measurement Job(s) are created for threshold monitoring purposes. 

(See 6.3.8.1 for clarification of the alternatives (a) and (b)) 



7.4.1.2 



Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


iOCName 


M 


ManagedEntity . ob jectClass 


It specifies the ManagedEntity 
class name of the instances 
specified by IOCInstanceList. 


iOCInstanceList 


M 


List of <ManagedEntitY . objectInstance> 


It specifies the DNs of 

IVIanagedEntity instances whose 

measurementTypes are to be 

monitored. 

At least, one instance shall be 

specified. 


thresholdlnfoList 


M 


List of 

< MeasuredAttribute .measurementTypeName, 

Monitor . probableCause, 

Monitor . specif icProblem, 

Monitor .direction, 

threslioldPacl< 

> 

wliere threslioldPacl< is list of tliresholdPacl<Element. 
The thresholdPacl<Element is STRUCT 

< 

ThresholdLevel . thresholdValue, 
ThresholdLevel . thresholdSeverity, 
ThresholdLevel . hysteresis, 

> 


It specifies the thresholds to 
specific measurementTypes. 
See clause 6.5.1 (definition and 
legal values). 
The number of 
ThresholdLevel in 
thresholdLevelList must 
be 1,2, 3 or 4. 


monitorGranularity 
Period 


M 


Monitor .monitorGranularityPeriod 


See clause 6.5.1 (definition and 
legal values). 
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7.4.1.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


monitorld 


M 


Monitor .monitorld. 


It specifies the unique identifier of the 
ThresholdMonitor in the PMIRP Agent. 


unsupportedList 


M 


List of < 

ManagedEntity . ob jectClass, 

ManagedEntity . ob jectlnstance, 

MeasuredAttribute . 

measurement TypeName, 

reason 

> 


To create a ThresholdMonitor, best-effort 
is required. This parameter identifies the 
unsupported but requested 
measurementType(s). 
The reason can be: 

(a) The pmirp has trouble starting monitoring 
the threshold of this measurementType. 

(b) The measurementType is illegal. 

(c) The measurementType exists but it is not 
currently under monitoring by any 
Measurement Job and that the PMIRP 
requires that it be under monitoring by 
Measurement Job (before it can be 
monitored for thresholding). 

(d) Hysteresis is overlapped. 

This parameter is used only when the 
operation returns 'PartialSuccess'. 


status 


M 


ENUM (Success, Failure, PartialSuccess) 


An operation may fail because of a specified or 
unspecified reason. 



7.4.1.4 



Pre-condition 



validGranularityPeriod AND someValidMeasurementType AND validDirection AND 
validNumberOf ThresholdPackElements AND validOrderOf ThresholdPackElements. 



Assertion Name 


Definition 


validGranularityPeriod 


The monitorGranularityPeriod is valid. 


someValidMeasurementType 


At least one requested measurementType can be monitored for thresholding. 


validDirection 


The direction is valid. 


validNumberOfThresholdPackElements 


If PMIRP supports multi-level thresholdSeverity, it is valid if the number of 
elements in thresholdPack is 1 , 2, 3 or 4. 

If PIVIIRP does not support multi-level thresholdSeverity, it is valid if the 
number is 1. 


validOrderOfThresholdPackElements 


This assertion is applicable if pmirp supports multi-level thresholdSeverity. It 
is valid if it satisfies the constraint defined by multiLevelSeverityOrder of 
clause 6.5.2 (constrains). 



7.4.1.5 Post-condition 

thresholdMonitorlsCreated AND notifyOb jectCreationEmitted. 



Assertion Name 


Definition 


thresholdMonitorlsCreated 


The ThresholdMonitor identified by monitorld exists. And the performance alarm shall be 
emitted if the thresholds are (a) crossed or (b) reached and the thresholdMonitorStatus 
Is "Active". (See 6.3.8.1 for clarification of the alternatives (a) and (b)) 
The ThresholdMonitor.thresholdMonitorStatus will be Active. 


notifyObjectCreationEmitted. 


The notifyObjectCreation is emitted to indicate the creation of a ThresholdMonitor. 



£75/ 



3GPP TS 32.412 version 6.3.0 Release 6 



37 



ETSI TS 132 412 V6.3.0 (2004-12) 



7.4.1.6 



Exceptions 



Exception Name 


Definition 


invalidClassOrlnstances 


Condition: (validClassAndlnstances) not verified. 

Returned information: output parameter status is set to 'Failure'. 

Exit state: Entry State. 


invalidGranularityPeriod 


Condition: (validGranularityPeriod) not verified. 

Returned Information: Name of tine exception; status is set to 'Failure'. 

Exit state: Entry state. 


noValidMeasurementType 


Condition: (someValidlVleasurementType) not verified. 
Returned information: output parameter status is set to 'Failure'. 
Exit state: Entry State. 


invalidNumberOfThresholdPackE 
lements 


Condition: (validNumberOfThresholdPackElements) not verified. 
Returned information: output parameter status is set to 'Failure'. 
Exit state: Entry State. 


invalidOrderOfThresholdPackEle 
merits 


Condition: (validOrderOfThresholdPackElements) not verified. 
Returned information: output parameter status is set to 'Failure'. 
Exit state: Entry State. 


invalidDirection 


Condition: (validDirection) not verified. 

Returned information: output parameter status is set to 'Failure'. 

Exit state: Entry State. 



7.4.2 Operation deleteThresholdMonitor (M) 
7.4.2.1 Definition 

This operation supports IRPManager's request to delete a specified ThresholdMonitor. 

At the time of the removal, all outstanding (a) threshold-crossing or (b) threshold reaching alarms will stay (i.e. the 
FMIRP Agent's AlarmList will contain an Alarmlnf ormation indicating (a) threshold-crossing or (b) threshold 
reaching). The IRPManager needs to use other means to remove the Alarmlnf ormation in the FMIRP 
AlarmList. (See 6.3.8.1 for clarification of the alternatives (a) and (b)) 



7.4.2.2 



Input parameters 



Parameter 
Name 


Qualifier 


Information type 


Comment 


monltorld 


M 


ThresholdMonitor .monltorld 


It specifies the ThresholdMonitor to be Stopped and 
removed. 



7.4.2.3 



Output parameters 



Parameter 
Name 


Qualifier 


Matching Information 


Comment 


status 


M 


ENUM (Success, 
Failure) 


An operation may fail because of a specified or unspecified 
reason. 



7.4.2.4 



Pre-condition 



thresholdMonltorExlsts. 



Assertion Name 


Definition 


thresholdlVlonitorExists 


ThresholdMonitor specified in the input parameters exists. 



7.4.2.5 Post-condition 

thresholdMonltorlsDeleted AND notifyOb jectDeletionEmitted.. 
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Assertion Name 


Definition 


thresholdMonitorlsDeleted 


ThreshoidMonitor identified by monitorld ceases to exist. 


notifyObjectDeletionEmitted 


Tlie notifyObjectDeletion is emitted to indicate the deletion of a ThresholdlVlonitor. 



7.4.2.6 



Exceptions 



Exception Name 


Definition 


unl<nownThreslioldlVlonitor 


Condition: (threslioldlVlonitorExists) not verified. 

Returned information: output parameter status is set to 'Failure'. 

Exit state: Entry State. 



7.4.3 Operation listThresholdMonitors (M) 



7.4.3.1 



Definition 



This operation supports IRPManager's request to list detailed information about all or specified 

ThresholdMonitors. 



7.4.3.2 



Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


monitorldList 


M 


List of 

<ThresholdMonitor .monitorId> 


This parameter specifies the 

ThresholdMonitors tO be listed. 

If the parameter specifies the list of monitorlds, 
then the corresponding information of 
ThresholdMonitors will be returned. 

If the parameter contains no information, all the 
ThresholdMonitors in the PMIRP Agent will 
be returned. 



7.4.3.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


monltorlnfoList 


M 


List of < 

attributes of ThreshoidMonitor (see 

definition and legal values in clause 6.5.1), 

iOCName, 

iOCInstanceList, 

thresholdlnfoList (See clause 7.4.1 .2 input 

parameters of create thresholdlVlonitor 

operation) 

> 


Returned information of 
corresponding 

ThresholdMonitors matching the 
input criteria. If no match, then the 
length of the monitorlnfolist will be 
(with status == Success). 


status 


M 


ENUM (Success, Failure) 


An operation may fail because of a 
specified or unspecified reason. 



7.4.3.4 Pre-condition 

monitorldList IsValid. 



Assertion Name 


Definition 


monitorldListlsValid 


monitorldList specified in the input parameter is valid. 
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7.4.3.5 



Post-condition 



thresholdMonitorsAreReturned AND thresholdsAreUnaf f ected. 



Assertion Name 


Definition 


thresholdMonitorsAre 
Returned 


The information of required ThresholdMonitors are returned in the output parameters. 


thresholdsAreUnaffected 


The ThresholdMonitors are not affected. 



7.4.3.6 



Exceptions 



Exception Name 


Definition 


invalidMonitorldList 


Condition: (monitorldLlstlsValid) not verified. 

Returned information: output parameter status is set to 'Failure'. 

Exit state: Entry State. 



7.5 PMIRPOperations_3 Interface (O) 
7.5.1 Operation suspendThresholdMonitor (M) 



7.5.1.1 



Definition 



This operation supports IRPManager's request to suspend the ThresholdMonitor . If the operation succeed, its 
thresholdMonitorStatus shall be set to "Suspended". PMIRP shall not emit performance alarms related to this 
ThresholdMonitor. The ThresholdMonitor shall still exist. 



7.5.1.2 



Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


monitorld 


M 


ThresholdMonitor .monitorld It specifies the ThresholdMonitor tO be Suspended. 



7.5.1.3 



Output parameters 



Parameter 
Name 


Qualifier 


Matching Information 


Comment 


Status 


M 


ENUIVI (Success, 
Failure) 


An operation may fail because of a specified or unspecified 
reason. 



7.5.1.4 



Pre-condition 



thresholdMonitorExists AND thresholdMonitorlsNotSuspended. 



Assertion Name 


Definition 


thresholdMonitorExists 


ThresholdMonitor specified in the input parameter exists. 


thresholdMonitorlsNotSuspended 


ThresholdMonitor specified in the input parameter is not suspended. 
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7.5.1.5 Post-condition 

t hr e s ho IdMon it or Is Suspended AND notif yThresholdMonitorStatusChangedEmitted. 



Assertion Name 


Definition 


thresholdMonitorlsSuspended 


The ThreshoidMonitor identified by monitorld is suspended, that means it 
will not work until it is resumed. The 

ThreshoidMonitor .thresholdMonitorStatus will be 'Suspended'. 


notifyThresholdMonitorStatusCha 
ngedEmitted 


The notify ThresholdMonitorStatusChanged is emitted. 



7.5.1.6 



Exceptions 



Exception Name 


Definition 


unknownThresholdlVlonitor 


Condition: (thresholdlVlonitorExists) not verified. 

Returned information: output parameter status is set to 'Failure'. 

Exit state: Entry State. 


thresholdMonitorAlreadySuspended 


Condition: (thresholdlVlonitorlsNotSuspended) not verified. 
Returned information: output parameter status is set to 'Failure'. 
Exit state: Entry State. 



7.5.2 Operation resumeThresholdMonitor (M) 

7.5.2.1 Definition 

This operation supports IRPManager's request to resume a suspended ThreshoidMonitor . 

7.5.2.2 Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


monitorld 


M 


ThreshoidMonitor .monitorld 


It specifies the ThreshoidMonitor to be resumed. 



7.5.2.3 



Output parameters 



Parameter 
Name 


Qualifier 


Matching Information 


Comment 


status 


M 


ENUM (Success, 
Failure) 


An operation may fail because of a specified or unspecified 
reason. 



7.5.2.4 



Pre-condition 



thresholdMonitorExists AND thresholdMonitorlsSuspended. 



Assertion Name 


Definition 


thresholdMonitorExists 


ThreshoidMonitor specified in the input parameter exists. 


thresholdMonitorlsSuspended 


ThreshoidMonitor specified in the input parameter is suspended. 
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7.5.2.5 Post-condition 

thresholdMonitorlsResumed AND notif yThresholdMonitorStatusChangedEmitted. 



Assertion Name 


Definition 


thresholdMonitorlsResumed. 


The ThreshoidMonitor identified by monitorld is resumed, that means it will work again. 

The ThreshoidMonitor .thresholdMonitorStatus will be "Active'. 


notify ThresholdMonitorStatu 
sChangedEmitted 


The notifyThresholdlVlonitorStatusChanged is emitted. 



7.5.2.6 



Exceptions 



Exception Name 


Definition 


unknownThresholdlVlonitor 


Condition: (thresholdlVlonitorExists) not verified. 

Returned information: output parameter status is set to 'Failure'. 

Exit state: Entry State. 


thresholdMonitorlsNotSuspended 


Condition: (thresholdlVlonitorlsSuspended) not verified. 
Returned information: output parameter status is set to 'Failure'. 
Exit state: Entry State. 



7.6 PMIRPNotification_1 Interface (M) 
7.6.1 notifyMeasurementJobStatusChanged (M) 



7.6.1.1 



Definition 



The PMIRP Agent notifies all subscribed IRPManagers about the status changes of a Measurement Job. The 
status changes in that case include Suspended=>Scheduled, Active=>Suspended, Scheduled=>Suspended, 
Suspended=>Active, Scheduled=>Active, Active=>Stopped, Suspended=>Stopped, Scheduled=>Stopped. 



7.6.1.2 



Input parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


objectClass 


M 


PMIRP.objectClass 


This parameter and objectlnstance together carry 
the same semantics of IRPAgent. systemDN. 
Notification header - see 3GPP TS 32.302 [12]. 


objectlnstance 


M 


PIVIIRP.objectlnstance 


This parameter and objectClass together carry the 
same semantics of IRPAgent.systemDN. 
Notification header - see 3GPP TS 32.302 [12]. 


notificationid 


M 


— 


Notification header - see 3GPP TS 32.302 [12]. 


eventTime 


M 


- 


Notification header - see 3GPP TS 32.302 [12]. 


notificationType 


M 


"notifyMeasurementJobStatusCh 
anged". 


Notification header - see 3GPP TS 32.302 [12]. 


systemDN 


C 


IRP Agent . systemDN. 


It carries the DN of the irp Agent that emits this 
notification. Notification header - see 
3GPPTS 32.302 [12] 


jobid 


M 


Measurement Job. jobId 




jobStatus 


M 


Measurement Job. jobStatus 


The new status of the Measurement Job . 


reason 





String 


It carries one or several of the assertion names of 
the From-state of Triggering Event. 



£75/ 



3GPP TS 32.412 version 6.3.0 Release 6 



42 



ETSI TS 132 412 V6.3.0 (2004-12) 



7.6.1.3 



Triggering Event 



7.6.1.3.1 



From-state 



f ailToReadMeasurementTypesForExtendedProlongPeriod OR internalProblem OR 
stopMeasurement Job OR stopTimeReached OR resumeMeasurement Job OR 
suspendMeasurement Job OR startTimeReached OR suspendMeasurement JobBySystem 



Assertion Name 


Definition 


failToRead MeasurementType 
sForExtendedProlongPeriod 


Because the pmirp Agent have failed to read the monitored measurementType (s) 
from managed resources for one or more times, the pmirp Agent decides that it 
will not try to read in the future and place the Measurement Job in "Stopped" 
state. 


internalProblem 


Because of an unspecified internal problem, pmirp Agent decides that it no longer 
can maintain the Measurement Job in any jobStatus but "Stopped". 


stopMeasurementJob 


The StopMeasurementJob returns SUCCess. 


StopTimeReached 


The stop time for Measurement Job has been reached. 


resumeMeasurementJob 


The resumeMeasurementJob returns success. 


suspendMeasurementJob 


The suspendMeasurementJob returns SUCCess. 


StartTimeReached 


The start time for Measurement Job has been reached. 


suspendMeasurementJobBySystem 


The IVIeasurementJob has been suspended by the system in case of overload 



7.6.1.3.2 To-state 

measurementJobStatusChanged 



Assertion Name 


Definition 


measurementJobStatusChanged 


The Measurement Job . jobStatus changed to a new value. 
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7.6.2 notifyThresholdMonitorStatusChanged (O) 



7.6.2.1 



Definition 



The PMIRP Agent notifies all subscribed IRPManagers about the status changes of a ThresholdMonitor. The 
status changes in that case include Suspended=>Active, Active=>Suspended. 

NOTE: The notifyThresholdMonitorStatusChanged notification is mandatory if PMIRPOperations_2 is 
supported. 

7.6.2.2 Input Parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


objectClass 


M 


PMIRP.objectClass 


This parameter and objectlnstance together carry 
the same semantics of IRPAgent.systemDN. 
Notification header - see 3GPP TS 32.302 [12] 


objectlnstance 


M 


PMIRP.objectlnstance 


This parameter and objectClass together carry the 
same semantics of IRPAgent.systemDN. 
Notification header - see 3GPP TS 32.302 [12] 


notificationid 


M 


- 


Notification header - see 3GPP TS 32.302 [12] 


eventJime 


M 


- 


Notification header - see 3GPP TS 32.302 [12] 


notificationType 


M 


"notifyThresholdMonitorStatusChang 
ed". 


Notification header - see 3GPP TS 32.302 [12] 


system DN 


C 


IRP Agent . systemDN. 


It carries the DN of the irp Agent that emits this 
notification. Notification header - see 
3GPPTS 32.302 [12] 


monitorld 


M 


ThresholdMonitor .monitorld 




monitorStatus 


M 


ThresholdMonitor . thresholdM 
onitorStatus 


The new status of the ThresholdMonitor . 


reason 





String 


It carries one or several of the assertion names of 
the From-state of Triggering Event. 



7.6.2.3 



Triggering Event 



7.6.2.3.1 From-state 

resumeThresholdMonitor OR suspendThresholdMonitor 



Assertion Name 


Definition 


resumeThresholdMonitor 


The resumeThresholdMonitor returns success. 


suspendThresholdlVlonitor 


The suspendThresholdMonitor returns success. 



7.6.2.3.2 To-state 

thresholdMonitorStatusChanged 



Assertion Name 


Definition 


thresholdMonitorStatusChanged 


The ThresholdMonitor . threshoidMonitorStatus Changed to a new value. 
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8 



Scenarios 



8.1 



createMeasurementJob 



:NM 



: IRPAgent 



createMeasurementJob 



return success 



-^ 



«- 



If schedule is reached, PMIRP Agent begins to collect the data\ 
according to the input parameters, and emit the 
notifyFileReady notification at the end of each reporting 
period. Now the jobStatus is "Active". 

notifyFileReady 



IRPManager mayget^ 



file(s) by 
Transfer 



File 
IRP. 



<r 



<r 



listMeasurementJobsf 



return required info 



-^ 



IRPManager can request PMIRP t\ 
Agent to list all the jobs for the 

specified filter. 

listFllesO 



return required info 



-> 



IRPManager can request PMIRP K 
Agent to list all the files for a 
specified job and filter. 



Figure 8.1 : Scenariol of Performance Management 
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8.2 stopMeasurementJob 



NM 



IRPAgent 



IRPManager can request PMIRP Agent 
to stop a specified job in any situation, 
nomattertlie jobSlatus is "Sclieduled", 
"/sctive" or "Suspended". 



stoplVleasurementJob () 



-> 



return success 



<- 



Figure 8.2: Scenario2 of Performance Management 
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8.3 stopMeasurementJob/listMeasurementJobs/listFiles 



:NM 



:IRPAaent 



IRPManager can request PMIRP Agent 
to stop a specified job in any situation, 
no matter the jobStatus is "Scheduled", 
"Active" or "Suspended". 



stoplVleasurementJob () 



->rJ 



^ 



return success 



listlVJeasurementJobsQ 



->J 



^- 



return required info 



If the measurementJob is not 
removed, the information of stopped 
measurementJob can be returned 



listFilesQ 



^ 



^ 



return required info 



If the files of a stopped 
measurementJob are still existing in 
the PMIRP Agent, their information can 
be returned to IRPI\/lanager if required. 



Figure 8.3: Scenarios of Performance IVIanagement 
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8.4 suspendMeasurementJob/resumeMeasurementJob 



NM 



:IRPAqent 



IRPManager can request PMIRP Agent to 
suspend a "Scheduled" or "Active" job in 
some situation, such as high work load. 



suspendl\/leasurementJob() 



->^ 



return success 



^ 



If the "suspend" operation is 
successful, the jobStatus is changed 
to "Suspended" accordingly. 



IRPIVlanager can request 
PMIRP Agent to resume 
a "Suspended" job. 



resumeMeasurementJobO 



-> 



^ 



return success 



If the "resume" operation is 
successful, the jobStatus 
is changed to "Scheduled" 
or "Active" according to the 
job schedule. 



Figure 8.4: Scenario4 of Performance Management 
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Annex A (normative): 

Illustration of the state described in the state Diagram 

A.1 Definition of state 
A.1.1 Scheduled 

"Scheduled" means that the job has been created and the start time has not been reached. 

A.1.2 Suspended 

"Suspended" means that the job has been suspended for some reason. 

A. 1.3 Active 

"Active" means that the start time of a Measurement Job has been reached. 

There are two sub-states: "Busy" and "Idle". 

"Busy" means that the Measurement Job is monitoring the measurementTypes. 

"Idle" means that the Measurement Job is not monitoring the measurementTypes. 

When a Measurement Job becomes active, it does not mean that the job is immediately busy. IRPManager can set 
the detailed time frame (e.g. dailySchedule or weeklySchedule) for a Measurement Job to be busy. If there is no time 
frame schedule for a job, it immediately monitors the measurement types when it becomes active. 

A. 1.4 Stopped 

"Stopped" means that the Measurement Job is deleted via the Itf-N. Whether the managed system removes the 
Measurement Job immediately or later is vendor specific. 
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A.2 State transition scenarios 

The following scenarios give examples of state transitions. 



A.2.1 Scenario 1 

A Measurement Job is created at 11:00, and the startTime is 14:00, stopTime is 18:00. At 12:00, the 

Measurement Job is suspended, and at 13:00, the Measurement Job is resumed. 



job is Scheduled ' job is Suspended ' job is Scheduled | job is Active 



-•k 



-M- 



-►r*- 



11:00 



12:00 



13:00 



14:00 



Time 



create 
measurement job 



suspend 
measurement job 



resume 
measurement job 



start 

time reached 



At 1 1 :00: the Measurement Job becomes scheduled after it was created. 

At 12:00: the Measurement Job is suspended and the jobStatus is "Suspended". 

At 13:00: the Measurement Job is resumed, and the jobStatus is "Scheduled" because the start time has not been 

reached. 
At 14:00: the Measurement Job becomes active because start time has been reached. 



Figure A.1 : Scenario 1 



A.2.2 Scenario 2 



A Measurement Job is created at 11:00, and the startTime is 12:00, stopTime is 18:00. At 13:00, the 
Measurement Job is suspended, and at 14:00, the Measurement Job is resumed. 



I job is Scheduled ' 

^ ik- 



job is Active 



-*^ 



job is Suspended , 



job is Active 

► 



11:00 



12:00 



13:00 



14:00 



Time 



create 
measurement job 



start 

time reached 



suspend 
measurement job 



resume 
measurement job 



At 1 1 :00 
At 12:00 
At 13:00 
At 14:00 



the Measurement Job becomes scheduled after it was created, 
the start time is reached, and the jobStatus is "Active", 
the Measurement Job is suspended, and the jobStatus is "Suspended" 
the Measurement Job is resumed, and the jobStatus is "Active". 

Figure A.2: Scenario 2 
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A.2.3 Scenario 3 

A Measurement Job is created at 1 1:00 and the startTime is 12:00, stopTime is never stop. There is no other 
schedule defined. IRPManager stops the job at 14:00. 



I job is Scheduled ' 

^ (k- 



job is Active 



11:00 



12:00 



create 
measurement job 



start 

time reached 



13:00 



14:00 



Time 



stop 
measurement job 



At 12:00: the Measurement Job becomes active wlien start time is reached. Since there is no schedule for the job, 

it starts monitoring measurement types immediately. 
At 14:00: the Measurement Job is Stopped when IRPManager Stops the job. 



Figure A.3: Scenario 3 



A.2.4 Scenario 4 



A Measurement Job is created at 11:00 and the startTime is 12:00, stopTime is 14:00. There is no other schedule 
defined. 



I I 

I job is Scheduled ' 

J^ «k- 



job is Active 



I 



->! 



11:00 



12:00 



13:00 



14:00 



Time 



create 
measurement job 



start 

time reached 



stop time reached 



At 12:00: the Measurement Job becomes active when start time is reached. Since there is no schedule for the job, 

it starts monitoring measurement types immediately. 
At 14:00: the Measurement Job is Stopped automatically when stop time is reached. 

Figure A.4: Scenario 4 
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A.2.5 Scenario 5 

A Measurement Job is created at 1 1:00 and the startTime is 12:00, stopTime is "never stop". There is a 
dailySchedule defined, which is 13:00-14:00 and 15:00-16:00 every day. 



job is Active 



job is 



job is Busy 



! Scheduled 1 Job is Idle r ^J job is Idle I 



job is Busy 




11:00 



start 

time reached 



dailySchedule 



create 
measurement job 



At 12:00: the Measurement Job becomes active when start time has been reached. Since there is a schedule for 
the job, the job monitors measurement types only during the specified schedule. During other times, the 
job is idle. 

At 13:00 and 15:00: the Measurement Job becomes busy when the daily schedule has been reached. 

Figure A.5: Scenario 5 
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A.2.6 Scenario 6 

A Measurement Job is created at 11:00 and the startTime is 12:00, stopTime is 13:30. The 

Measurement Job . granularityPeriod is 30 minutes and the Measurement Job . reportingPeriod is 1 

hour. There is no other schedule defined. 



I I 

I job is Scheduled ' 
k (k- 



job is Active and Busy 



I 



11:00 



create 
measurement job 



12:00 



start 

time reached 



13:00 



13:30 



14:00 



Time 



. t . — 



stop 

time reached 



file is available and a 
notifyFileReady 
notification is sent 



file is available 
and a 

notifyFileReady 
notification is sent 



At 12:00: the Measurement Job becomes active when start time is reached. Since there is no detailed time frame 

for the job, the job begins to worl< at the same time. 
At 13:00: the file(s) of the Measurement Job are available, and pmirp emits the notifyFileReady notification to 

subscripted IRPManager. 
At 13:30: the Measurement Job is automatically stopped when stop time is reached. 
At 14:00: pmirp will emit the last notifyFileReady notification. 

Figure A.6: Scenario 6 
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Annex B (normative): 

Threshold related performance alarms Triggering Events 

This annex defines the Triggering Events for the various performance alarms. The Triggering Events normally are 
defined by each notification type, such as notifyChangedAlarm, under the clause "Triggering Events". The 
Triggering Events related to thresholding are defined here collectively for ease of reference. 

The Triggering Events are defined in a state transition table. The column labels (e.g. 0, 1, 2, 3 of table in clause B. 1) 
denote the to-state while the row labels denote the from-state. The cell denotes the emission action. 

There are two clauses. Clause B.l defines the Triggering Events for IRP Agent that supports 
notifyChangedAlarm. Clause B.2 defines those for IRPAgent that does not support notifyChangedAlarm. 

Clause B.3 provides samples of triggering events. 



B.1 IRPAgent supporting notifyChangedAlarm 

Table B.l 





To State-0 


To State-1 


To State-2 


To State-3 


To State-4 


From 
State-0 


no emission 


1 notifyNewAlarm 


1 notifyNewAlarm 


1 notifyNewAlarm 


1 notifyNewAlarm 


From 
State-1 


1 notifyClearedAlarm 


no emission 


1 notifyChangedAlarm 


1 notifyChangedAlarm 


1 notifyChangedAlarm 


From 
State-2 


1 notifyClearedAlarm 


1 notifyChangedAlarm 


no emission 


1 notifyChangedAlarm 


1 notifyChangedAlarm 


From 
State-3 


1 notifyClearedAlarm 


1 notifyChangedAlarm 


1 notifyChangedAlarm 


no emission 


1 notifyChangedAlarm 


From 
State-4 


1 notifyClearedAlarm 


1 notifyChangedAlarm 


1 notifyChangedAlarm 


1 notifyChangedAlarm 


no emission 



The horizontal '0', T, '2', '3' and '4' are the to-states indicating the current measurementType value with respect to the 
different threshold levels. Threshold levels are associated with severity level (thresholdSeverity). Higher threshold level 
associates with higher severity level (thresholdSeverity). 

EXAMPLE: If direction = Increasing', state-0 means the measurementType value is below all thresholds. 
State-2 means that the measurementType value is above threshold level 2 but below threshold 
level 3. If direction = 'Decreasing', state-0 means the measurementType value is above all 
thresholds. State-2 means that the measurementType value is below threshold level 2 but above 
threshold level 3. 

The vertical '0', '1', '2", '3' and '4' are the from-states indicating the last-read measurementType value with respect to the 
threshold levels. 

A threshold has a value and may have a hysteresis. A threshold with hysteresis has a threshold-high value and a 
threshold-low value that are different from the threshold value. A threshold without hysteresis can be considered as a 
threshold whose threshold-high and threshold-low values are equal to the threshold value. 

For the direction = 'Increasing', the shaded cells indicate transitions caused by measurementType values (a) rising 
across or (b) reach one or more threshold-high values. The non-shaded cells indicate transition caused by 
measurementType values falling across one or more threshold-low values. 

For the direction = 'Decreasing', the shaded cells indicate transitions caused by measurementType values (a) falling 
across or (b) reach one or more threshold-low values. The non-shaded cells indicate transition caused by 
measurementType values rising across one or more threshold-high values. 

Each cell indicates the performance alarm emission when from-state transits to to-state. The notifyNewAlarm and 
notifyChangedAlarm shall carry the severity level (perceivedSeverity) associated with the to-state 
(thresholdSeverity). 
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The ThresholdMonitor determines, at momtorGP=X, if a threshold has been (a) crossed or (b) reached by 
comparing the value read at monitorGP==X with the value read at monitorGP==X-l. In initial condition (i.e. when the 
ThresholdMonitor reads the value at monitorGP=l), the (hypothetical) value read at monitorGP==X-l is assumed to be 
at state-0. 

(See 6.3.8.1 for clarification of the alternatives (a) and (b)) 



B.2 IRPAgent not supporting notifyChangedAlarm 

Table B.2 





To State-0 


To State-1 


To State-2 


To State-3 


To State-4 


From 
State-0 


no emission 


1 notifyNewAlarm 


1 notifyNewAlarm 


1 notifyNewAlarm 


1 notifyNewAlarm 


From 
State-1 


1 notifyClearedAlarm 


no emission 


1 notifyClearedAlarm 
1 notifyNewAlarm 


1 notifyClearedAlarm 
1 notifyNewAlarm 


1 notifyClearedAlarm 
1 notifyNewAlarm 


From 
State-2 


1 notifyClearedAlarm 


1 notifyClearedAlarm 
1 notifyNewAlarm 


no emission 


1 notifyClearedAlarm 
1 notifyNewAlarm 


1 notifyClearedAlarm 
1 notifyNewAlarm 


From 
State-3 


1 notifyClearedAlarm 


1 notifyClearedAlarm 
1 notifyNewAlarm 


1 notifyClearedAlarm 
1 notifyNewAlarm 


no emission 


1 notifyClearedAlarm 
1 notifyNewAlarm 


To State-4 


1 notifyClearedAlarm 


1 notifyClearedAlarm 
1 notifyNewAlarm 


1 notifyClearedAlarm 
1 notifyNewAlarm 


1 notifyClearedAlarm 
1 notifyNewAlarm 


no emission 



The Monitor determines, at monitorGP=X, if a threshold has been crossed by comparing the value read at monitorGP 
==X with the value read at monitorGP ==X-1. In initial condition (i.e. when the Monitor reads the value at monitorGP 
=1), the (hypothetical) value read at monitorGP ==X-1 is assumed to be at state-0. 



B.3 Examples 
B.3.1 Example 1 

Figure B.l illustrates multi-level thresholdSeverity thresholding behaviour. The horizontal axis indicates the time 
intervals specified by the Monitor .monitorGranularityPeriod (monitorGP). The vertical axis indicates the 
monitored measurementType values. The measurementType of this example is of type gauge. The 

Monitor . direction is set to "Increasing". 

Further suppose that the measurementType is monitored for a (a) two-level-severity-threshold-crossings or (b) two- 
level-severity-threshold reaching. (See 6.3.8.1 for clarification of the alternatives (a) and (b)) 

The threshold for the lower-level-severity is set to 3 with a hysteresis low and high levels set to 2 and 4 respectively 
(i.e. hysteresis value =1). The thresholdSeverity level is Minor. 

The threshold for the higher-level-severity is set to 7 with a hysteresis low and high levels set to 6 and 8 respectively 
(i.e. hysteresis value =1). The thresholdSeverity level is Major. 

The performance alarm triggering events are: 

1. At monitorGP interval 3, trigger a notifyNewAlarm with perceivedSeverity (ps) = Minor. 

2. At monitorGP interval 5, if the IRPAgent supports notifyChangedAlarm, trigger a 
notifyChangedAlarm with ps = Major; else a notif yClearAlarm and a notifyNewAlarm with ps 
= Major. 

3. At monitorGP interval 8, if the IRPAgent supports notifyChangedAlarm, trigger a 
notifyChangedAlarm with ps = Minor; else a notifyClearAlarm and a notifyNewAlarm with ps 
= Minor. 

4. At monitorGP interval 15, trigger a notifyClearedAlarm clearing the last emitted Minor alarm. 
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Thresholding behavior for direction Increasing for Gauge type f^lVIAttribute 
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Threshold Granularity Period time intervals 

Figure B.I 



B.3.2 Example 2 



Figure B.2 illustrates another multi-level thresholdSeverity thresholding behaviour for IRP Agent supporting 
notif yChangedAlarm. The horizontal axis indicates the time intervals specified by the GP. The vertical axis 
indicates the monitored measurementType values. The measurementType of this example is of type gauge. The 

Monitor . direction is set to "Decreasing". 

Further suppose that the measurementType is monitored for a two-level thresholdSeverity (a) threshold-crossing or (b) 
threshold reaching. (See 6.3.8.1 for clarification of the alternatives (a) and (b)) 

The threshold for the major-level thresholdSeverity is set to 7 with a hysteresis high and low levels set to 6 and 8 
respectively. 

The threshold for the minor-level thresholdSeverity is set to 9 with a hysteresis high and low levels set to 8 and 10 
respectively. 

The performance alarm triggering events are: 

1. At monitorGP interval 1, trigger a notifyNewAlarm with ps = Major. See table B.l table for transition 
State-0 to State-2. 

2. At monitorGP interval 5, trigger a notifyChangedAlarm with ps = Minor. See table B.l for transition 
State-2 to State- 1. 

3. At monitorGP interval 8, trigger a notifyChangedAlarm with ps = Major. See table B.l for transition 
State- 1 to State-2. 
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Thresholding behavior for direction Decreasing for Gauge type PIVIAttribute 
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Figure B.2 



B.3.3 Example 3 



Figure B.3 illustrates a single-level thresholding behaviour. The horizontal axis indicates the time intervals specified by 
the monitorGP. The vertical axis indicates the monitored measurementType values. The measurementType of this 
example is of type gauge. The Monitor . direction is set to "Increasing". 

The threshold is set to 4 with a hysteresis high and low levels set to 5 and 3 respectively. The thresholdSeverity level is 
Critical. 

The performance alarm triggering events are: 

1. At monitorGP interval 3, trigger a notifyNewAlarm with ps = Critical. 

2. At monitorGP interval 11, trigger a notifyClearedAlarm withps = Cleared. 

Hysteresis at 4 with high and low 
level set at 5 and 3 respectively 



Thresholding behavior with hysteresis 
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Threshold granularity period time intervals 

Figure B.3 
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